Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Editing Movies / Editing Movies

CopyMovieSelection

The CopyMovieSelection function creates a new movie that contains the original movie's current selection. This function does not change the original movie or the current selection.

pascal Movie CopyMovieSelection (Movie theMovie); 

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

DESCRIPTION

The CopyMovieSelection function returns a movie identifier. If the function could not create the new movie, it sets this returned identifier to nil.

Your application must dispose of the new movie once you are done with it. You can use the DisposeMovie function (described on page 2-83) to dispose of the new movie.

If you have assigned a progress function to the source movie, the Movie Toolbox calls that progress function during long copy operations. (For details on progress functions, see "Progress Functions" beginning on page 2-333.)

ERROR CODES

invalidMovie	-2010	This movie is corrupted or invalid
progressProcAborted	-2019	Your progress function returned an error

Memory Manager errors